home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 1 / PC Actual CD 01.iso / share / dos / sonido / cd-v15.arj / CD-V.DOC < prev    next >
Encoding:
Text File  |  1994-09-27  |  9.2 KB  |  215 lines
  1. ===============================================================================
  2.                           CD-V     ver     1.5
  3. ===============================================================================
  4.  
  5.                          An Audio-CD VGA Player
  6.  
  7.                              Itamar Grutman
  8.                                  Israel
  9.                                   1994
  10.  
  11. ===============================================================================
  12.  
  13.     This program was put as Public Domain by the author and may be distributed
  14. freely. It may not be sold, nor be made part of anything that is sold.
  15.  
  16. ===============================================================================
  17.  
  18. Description
  19. -----------
  20.     This program was written to fulfill my need for a VGA-based audio-cd player
  21. for DOS. It seemed that all the nice CD players were written for windows and I
  22. found nothing for DOS. Since I don't like using the mouse in text mode, I wrote
  23. a graphic player.
  24.  
  25.     The program has a very simple interface and includes all the buttons one
  26. would expect to find in an advanced CD player as well as a blank screen saver.
  27.  
  28.     The bottom row of buttons corresponds to usual commands (e.g. stop,play)
  29. where the play button serves also as pause (toggle).
  30.     The eject/close-tray button is on the right of the time display. When
  31. ejected or not ready, all buttons (except eject and PWR) are grayed (whited).
  32.     The top row of buttons contains special purpose buttons, which are (from
  33. left to right) : Power, Track display(enables to select a track), Statistics
  34. display(Show totals and progress bars), Direction(Toggles between increasing or
  35. decreasing time),Play mode (sequential or ordered),Volume control,Mute and
  36. finally - About.
  37.     All the top row buttons are togglers (except PWR, of course).
  38.  
  39.  
  40. NOTE :  Volume control will work only for those devices that support it. It does
  41.         not make use of the sound card, therefore, the sound card itself should
  42.         be set to it's maximum level to get the full scale of the volume bar.
  43.  
  44.  
  45. Instructions
  46. ------------
  47. I will provide instructions only for what isn't obvious.
  48.  
  49. Screen saver :
  50.     Will either operate after a specified time (see configuration) of no
  51. movement or when the mouse is moved to the upper-left corner of the screen and
  52. remains idle there for 2 seconds.
  53. Moving the mouse or pressing a letter key on the keyboard will shut off the
  54. screen saver and return the program to the screen.
  55.  
  56. Configuration :
  57.     If a file called "cd-v.cfg" exists in the directory cd-v is run from, cd-v
  58. will read it's configuration from it. A sample file is included.
  59. The format is spartanic : The first number indicates the number of seconds to
  60. wait for the activation of the screen saver. A zero disables the screen saver.
  61. The second number indicates the starting volume level (ranging 0 to 255). A
  62. negative number means that the current volume level should be used.
  63. The third number holds the ascii of the key that will be used for addition of
  64. a track to the track list (see below - Track order selection).
  65. The following 4 numbers indicate the initial state of 4 of the togglers :
  66. Track display, Statistics display, Direction and Volume control, by that order.
  67. 0 means the togglers are off and 1 (or any other) that they are on.
  68. The following 16 numbers are the palette values (which I highly recommend not to
  69. change). If the first of them is negative, all are ignored. If not, the values
  70. are read into the system palette.
  71. Given with the included configuration file are the numbers for the default
  72. gray-level palette. The numbers there correspond to the following colors :
  73.  
  74. BLACK          0
  75. BLUE           1
  76. GREEN          2
  77. CYAN           3
  78. RED            4
  79. MAGENTA        5
  80. LIGHTGRAY      7
  81. BROWN         20
  82. DARKGRAY      56
  83. LIGHTBLUE     57
  84. LIGHTGREEN    58
  85. LIGHTCYAN     59
  86. LIGHTRED      60
  87. LIGHTMAGENTA  61
  88. YELLOW        62
  89. WHITE         63
  90.  
  91.     As an example, changing between the entry containing 63 and the one
  92. containing 56 will result in all the buttons to be reversed (i.e. pressed
  93. instead of raised and raised instead of pressed).
  94.  
  95.  
  96. Track order selection :
  97.     Press the Play-Mode button (drawn as 1-2-3 on diagonal) and the track order
  98. list should appear as well as the track selection box (if it wasn't visible). If
  99. this is the first time this mode is selection during a run of the program, the
  100. list would be almost empty and the first entry whould appear as a pressed button
  101. with the value of 1.
  102. Selection of a track from the track list changes the number in the currently
  103. pressed button in the order list. After selecting a track, depress the next
  104. button or press the key '+' (or the key selected in the config file, defaulted
  105. to '`') or press the button marked '+' at the top, and choose a track similarly.
  106.     When choosing from the order list, you can always choose one of the tracks
  107. previously selected or the next-to-last selected track. You can't choose a
  108. specific button from the order list if there is an empty slot above it.
  109.     To erase the last entry to the list press the button marked '-' on the top
  110. or press the RIGHT mouse button when the mouse pointer is located on any of the
  111. buttons of the list. Keeping the button pressed longer the 2 secs will activate
  112. the autorepeat feature which will erase an entry every 0.2 secs as long as the
  113. button is pressed.
  114.     When leaving this mode, the track selection box will disappear if it wasn't
  115. visible when you entered the mode, or remain visible if it was visible before
  116. entering the mode.
  117.     Entering this mode another time will display the previously set list. The
  118. mode is NOT functional, however, when the list is not DISPLAYED.
  119.     The about box will disappear and not return if it was visible before
  120. entering the mode.
  121.  
  122. AutoRepeat :
  123.     When pressing a button longer than 1Sec, it gets released and if still
  124. pressed, will activate every 0.1Sec. Thus allowing true FF ,REW ,SKIP and PREV.
  125. The volume control autorepeat is faster ; The delay is only 0.5Sec and then then
  126. the button gets pressed every 0.01Sec (which is actually zero) and the volume is
  127. changed by a larger amount (10 levels instead of one with single press).
  128.  
  129.  
  130. Requirements
  131. ------------
  132. The program expects to find the following :
  133.  
  134. - Microsoft compatible mouse and driver
  135. - MSCDEX version 2.20 or up
  136. - VGA adapter
  137. - 386
  138.  
  139.  
  140. Author
  141. ------
  142. The author can be reached by e-mail address :
  143.  
  144.         igrutman@bguee.bgu.ac.il
  145.  
  146. Please send any observation, remark or suggestion you might have.
  147. I will try and code your suggestions if I like them and have the time.
  148.  
  149.  
  150. Thanks
  151. ------
  152. To Paul <something>, for being the first to contact me about the program.
  153.  
  154.  
  155. History
  156. -------
  157. 0.1  -  First version.
  158.  
  159. 0.2  -  Fixed bugs :
  160.         1. Font and screen drivers not found when run from another directory.
  161.            Fixed by moving them into the code thus leaving the only necessary
  162.            file to be cd-v.exe
  163.         2. Track length not updated in statistics window when track was changed
  164.            indirectly (by ff, rewind, or track finish).
  165.  
  166. 1.0  -  Added Track order selection for playing and indication of play mode
  167.         at the top-right corner of the time display.
  168.  
  169. 1.1  -  Fixed bugs :
  170.         1. Memory access violations causing strange screen behaviour.
  171.         2. When clicking on a blank slot from the track list, a number appeared.
  172.         3. Incorrect disk length when playing entire disk.
  173.  
  174. 1.2  -  Fixed bugs :
  175.         1. When entering without a CD and the tray is closed, the button would
  176.            operate properly (not operate) but would not get whited.
  177.         2. Tracks higher than 19 caused trouble due to incorrect BCD to decimal
  178.            conversion.
  179.  
  180.         Added features:
  181.         1. Added the ability to exit with the ESC key. ESC now functions as PWR.
  182.         2. Added AutoRepeat feature. When pressing a button longer than 1Sec, it
  183.            gets released and if still pressed, will activate every 0.1Sec. Thus
  184.            allowing true FF ,REW ,SKIP and PREV.
  185.         3. Added screen-saving ability.
  186.         4. Added configuration file cd-v.cfg
  187.  
  188. 1.3  -  Added features:
  189.         1. Added volume control.
  190.         2. Added the ability to change the system palette from the configuration
  191.            file.
  192.         3. Added the ability to change the initial state of commonly used
  193.            togglers.
  194.  
  195. 1.4  -  Added features:
  196.         1. Added mute button.
  197.         2. Added "sleep now" corner.
  198.         3. Ablitity to erase last entry from order list.
  199.         4. Use of the keyboard key '+' to add an empty entry to the order list
  200.            thus enabling faster filling of the list without running the mouse
  201.            back and forth.
  202.  
  203.         Arbitrary changes:
  204.         1. Swapped places of the buttons SKIP with PREV and FF with REW.
  205.  
  206.         Fixed bugs:
  207.         1. The program would terminate when pressing SKIP or PREV in ordering
  208.            mode and with the list empty. The list is now never really empty.
  209.  
  210. 1.5  -  Added features:
  211.         1. Added an entry in the config file to select one more key to function
  212.            as the key '+'.
  213.         2. Added two buttons on the track order selection buttons : Add new
  214.            entry and Remove last entry.
  215.